home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / music_utilities / pt010.dms / pt010.adf / JamCracker.doc < prev    next >
Text File  |  1990-09-18  |  11KB  |  274 lines
  1.  
  2.  
  3.           JamCracker V1.0 is Copyware, written by M. Gemmel.
  4.        Therefore, it should be copied to many others, spreading
  5.         it over the entire world.  It may be modified, cracked,
  6.        recracked and messed up as long as it remains clear that
  7.           the author, M. Gemmel has nothing to do with such
  8.           modifications and is in no way responsible for any
  9.                resulting physical and/or mental damage.
  10.  
  11.  
  12.  
  13. JAMCRACKER V1.0 FUNCTIONS
  14. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  15.  
  16. Make sure you have read the ReadMe file on this disk too.
  17.  
  18. This is not an official manual.  As you read this, features could have
  19. been changed, added or removed.  Don't expect this document to be
  20. complete.
  21.  
  22. All numbers displayed by JamCracker are hexadecimal.  This document
  23. will not teach how to interpret hexadecimal numbers, so if you're not
  24. familiar with this representation of numbers, please refer to the
  25. appropriate literature.  In this document, hexadecimal numbers are
  26. preceded by a $.
  27.  
  28.  
  29. SONG CONTROL
  30. ¨¨¨¨¨¨¨¨¨¨¨¨
  31.  
  32. This is the window where the song table can be altered, the song can
  33. be played, and where errors are displayed.
  34.  
  35.  - LENGTH indicates the current song length in patterns.  The length
  36.    of a song can be max. $FF patterns.  It is always > 0.
  37.  - POSITION indicates the current position in the song table.  0
  38.    Means the start of the table, $FE is the end.
  39.  - PATTERN is the pattern number at this POSITION.  You can change it
  40.    to play a different pattern at this POSITION.  You can't make it
  41.    larger than the highest pattern number you've allocated.
  42.  - SIZE displays the size of the song in bytes, as it will be when
  43.    saved.
  44.  - FREE MEM shows the amount of free CHIP memory.  All memory
  45.    allocated by JamCracker is CHIP memory.
  46.  - PLAY plays the song, starting at this POSITION.  When the last
  47.    position is done, it restarts at position 0.
  48.  - STOP stops playing the song. (See STOPPING PLAY)
  49.  - LOAD loads a song. (See THE FILE-REQUESTER)
  50.  - SAVE stores a song. (See THE FILE-REQUESTER).
  51.  - CLEAR clears the song and all patterns and instruments.  It will
  52.    ask you to confirm this choice.
  53.  - QUIT quits the program.  It will ask you to confirm this choice.
  54.  - ABOUT shows some information about the program.
  55.  - SHOW will let you take a look at the files, without doing anything
  56.    with them. (See THE FILE-REQUESTER).
  57.  - DELETE lets you delete a file. (See THE FILE-REQUESTER).
  58.  - The ERRORS area displays any errors you have made/caused.  Along
  59.    with an error message, the screen is flashed to get your attention
  60.    for the error.
  61.  
  62.  
  63. CUSTOM WAVEFORM
  64. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  65.  
  66. Here you can edit/load/save your own waveform, which can be used as
  67. an instrument.  Custom waveform sizes are $40 bytes.  They are much
  68. smaller than the common digitized instruments, and therefore, you can
  69. use a lot of them without wasting much memory.
  70.  
  71.  - To edit a waveform you just move around in the editor with the
  72.    left mousebutton pressed.
  73.  - ZERO clears this waveform.
  74.  - SINE generates a sine-waveform.
  75.  - TRIANGLE generates a triangle-waveform.
  76.  - SQUARE generates a square-waveform.
  77.  - SAW generates a sawtooth-waveform.
  78.  - RANDOM generates a randomly shaped waveform.
  79.  - FLIP X flips the waveform over the Y-axis.
  80.  - FLIP Y flips the waveform over the X-axis.
  81.  - DOUBLE doubles this waveform, which means it will sound an octave
  82.    higher.
  83.  - HALVE replaces this waveform with its first half.
  84.  - UNDO lets you undo any of the above functions, as well as UNDO
  85.    itself and LOAD.
  86.  - LOAD loads a waveform. (See THE FILE-REQUESTER)
  87.  - SAVE stores a waveform. (See THE FILE-REQUESTER)
  88.  
  89.  
  90. INSTRUMENT
  91. ¨¨¨¨¨¨¨¨¨¨
  92.  
  93. In this window you can determine which instrument to use for editing
  94. a pattern and playing notes directly.
  95.  
  96.  - NUMBER shows the current instrument number.  You may have up to
  97.    $100 instruments in memory (if they fit), but you can't increase
  98.    the NUMBER if the current instrument is not used (empty).
  99.  - SIZE shows the size of the current instrument in bytes.
  100.  - TYPE shows either '(None)' if there is no instrument here,
  101.    'Normal' if you've loaded a common digitized instrument here, or
  102.    'Custom' if this instrument is a custom waveform.
  103.  - NAME is the (displayable part of the) name of this instrument.
  104.  - LOAD loads an instrument. (See THE FILE-REQUESTER).  Note that if
  105.    you've saved a custom waveform, and you load it here, it will
  106.    become a 'Normal' instrument automatically.
  107.  - CLEAR removes this instrument from memory.
  108.  - ONCE/LOOP lets you determine if this instrument is played once,
  109.    or repeated at the end.  'Custom' instruments are always set on
  110.    LOOP.
  111.  - COPY FROM WAVEFORM makes the current custom waveform in the
  112.    Custom Waveform window the current instrument.  Although custom
  113.    waveforms are $40 bytes, SIZE will display $180 which is the amount
  114.    of memory a custom waveform consumes when it's made an instrument.
  115.  - COPY TO CUSTOM copies this instrument to the Custom Waveform
  116.    window.  You can do this only if the TYPE is 'custom' or if the
  117.    SIZE is $40.
  118.  - OCTAVE can be UPPER or LOWER.  It is the octave at which notes are
  119.    edited or played directly.
  120.  
  121.  
  122. PATTERN EDITOR
  123. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  124.  
  125. In this window you can edit all patterns used in a song.  Patterns are
  126. groups of 4 channels, and each channel is a group of notes.  Patterns
  127. can be max. $40 notes long, and min. 1 note.  When you click in this
  128. window, the pattern cursor becomes visible and you can start or
  129. continue editing notes.
  130.  
  131. You use the cursor keys to move the cursor in any direction.
  132. <Left shift> in combination with <cursor up> or <cursor down> will
  133. move the cursor $10 notes at a time.
  134.  
  135. The format of a note is:    XX YYY IISAAVVPVVVPPP
  136.  
  137. where:    IISAAVVPVVVPPP are the note's info-numbers.
  138.  
  139. and:    XX  is the note number (which cannot be changed like the rest);
  140.     YYY is the note itself.  It is '---' if there's no note here;
  141.     II  is the instrument used to play this note;
  142.     S   is the pattern play speed;
  143.     AA  is the arpeggio info;
  144.     VV  is the vibrato info;
  145.     P   is the phase-shift speed;
  146.     VVV is the volume info;
  147.     PPP is the portamento info;
  148.  
  149.  
  150. To enter a note, position the cursor over YYY and type a 'note key'.
  151. The same for all other info numbers; position the cursor, and enter
  152. the data.
  153.  
  154. S   - The play speed is a number from 0-$F.  It is the time in
  155.       1/50th of a second to wait between two notes.  If it is 0, the
  156.       speed will remain unaffected.
  157. AA  - These are two number from 0-$E each.  They set the arpeggio
  158.       notes.  Arpeggio is the rapid change of pitch of one note, so
  159.       that it will sound like two or three notes played
  160.       simultaneously.  Each number represents the YYY note number +
  161.       the number.  For example, if YYY is C-2, and AA is 30, the
  162.       notes C-2 and D#2 will be played.
  163. VV  - These are two numbers, from 0-$E, and from 0-$F.  The first
  164.       number is the vibrato size, the second is the vibrato speed.
  165. P   - The phase shift speed is a number from 0-$F.  It will have
  166.       effect only on custom instruments.  What is does is to shift
  167.       the phase of the played wave at a certain speed, which makes
  168.       the tone sound kind of special.
  169. VVV - The first V of the volume info is S, U, or D.  The next VV is a
  170.       number from 00 to $40.  If the first V is S, it means the volume
  171.       will be set at level VV.  If the first V is U, the volume will
  172.       slide up to level $40 with speed VV.  If the first V is D, the
  173.       volume will slide down to 0 with speed VV.
  174. PPP - The first V of the portamento info can also be S, U, or D. The
  175.       next PP can be a number from 00 to $7E.  U means the pitch will
  176.       slide up with speed PP, D lets the pitch slide down, and for S
  177.       to have effect you must have entered a note YYY.  S will then
  178.       slide the pitch to the pitch of the note YYY with speed PP.
  179.  
  180. All effects except arpeggio will stay in effect as long as possible,
  181. once they've been activated.
  182.  
  183. The TAB key, pressed at any position in AAVVPVVVPPP will enter one or
  184. more '-'.  It means that the current effect (for which you have
  185. pressed the TAB) will stop.  Pressing the TAB key over YYY will
  186. either make the current note the last note of this pattern (place a
  187. 'pattern break') or it will make the size $40 again if you press it
  188. over the last note of this pattern.
  189.  
  190. To insert a note, press RETURN.  All notes starting at the current
  191. position will be moved down.
  192. To delete a note, press BACKSPACE.  All notes starting at the next
  193. position will be moved up.  The last note becomes 'empty'.
  194. To delete a note without moving notes, press DEL.
  195.  
  196. When entering a note YYY, it will sound.  When entering an
  197. info-number, you will hear nothing (special).
  198.  
  199.  - PATTERN displays the current pattern number.  You may have up to
  200.    $100 patterns in memory (if they fit).  You can't increase the
  201.    PATTERN number if the current pattern is not yet used.  Note also
  202.    that you can't clear a pattern from memory like an instrument.
  203.  - CUT, COPY, and PASTE cuts, copies or pastes a pattern.
  204.  - CHANNEL lets you change the channel you want to edit.  You can
  205.    edit max. 4 channels of notes.
  206.  - CUT, COPY, and PASTE cuts, copies or pastes a channel.
  207.  - AUDIO can be ON or OFF, which means this channel will be heard or
  208.    not when playing the pattern or the song.
  209.  - PLAY plays this pattern.
  210.  - STOP stops playing. (See STOPPING PLAY)
  211.  - LOAD loads a pattern. (See THE FILE-REQUESTER)
  212.  - SAVE stores a pattern. (See THE FILE-REQUESTER)
  213.  
  214.  
  215. STOPPING PLAY
  216. ¨¨¨¨¨¨¨¨¨¨¨¨¨
  217.  
  218. The STOP gadgets are actually dummies.  You do not have to click them
  219. to stop playing.  To stop playing, just do anything that would get
  220. JamCracker's attention, like pressing any key or clicking any gadget.
  221.  
  222.  
  223. THE FILE-REQUESTER
  224. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  225.  
  226. When choosing LOAD, SAVE, SHOW or DELETE, you will be prompted for a
  227. file with JamCracker's file requester where all files/directories in
  228. the specified path are displayed alphabetically; .info files are
  229. ignored.
  230.  
  231. DF0:, DF1:, DF2:, DF3:, DH0:, and the parent directory can be chosen
  232. with the gadgets at the bottom.  You can click a file and then OK to
  233. do what you wanted to do, or you can click a directory to see its
  234. contents.
  235.  
  236. The file requester can create its own little file called '.beepdir'.
  237. If the disk is write-enabled, and there is enough room, all names
  238. will be saved in the file .beepdir in this path.  This is extremely
  239. time-saving when you're working with large directories (like
  240. instrument disks/directories).  When the file requester finds a
  241. .beepdir file, it will load it and assuming it is complete, the names
  242. will be displayed.  The only way to read the full directory without
  243. reading .beepdir is to select the path-stringgadget (by clicking in it
  244. and pressing return).
  245.  
  246. CANCEL cancels the operation, and nothing has happened.
  247.  
  248.  
  249. SPECIAL KEYS
  250. ¨¨¨¨¨¨¨¨¨¨¨¨
  251.  
  252. When you're not editing info-numbers in the Pattern Editor, the
  253. following keys will generate a tone:
  254.  
  255. ZSXDCVGBHNJM (lower octave), Q2W3ER5T6Y7U (upper octave)
  256.  
  257. The F1-key will change the octave (displayed in the Instrument
  258. window).
  259.  
  260. The F10-key will toggle the titlebar.
  261.  
  262. The left shift key will not only move the pattern cursor by $10
  263. notes, but when clicking an arrow-gadget, the number will increase or
  264. decrease by $10, if possible.
  265.  
  266.  
  267. One final note about this version: if the beep font is not in FONTS:
  268. or if there is insufficient memory, JamCracker will just exit without
  269. a warning.  A number of (semi-) bugs are known, but should not prevent
  270. 'normal' use of the software.
  271.  
  272.  
  273. M. Gemmel, author
  274.